home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / zclear.z / zclear
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. zzzzcccclllleeeeaaaarrrr((((3333GGGG))))                                                          zzzzcccclllleeeeaaaarrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      zzzzcccclllleeeeaaaarrrr - initializes the z-buffer of the current framebuffer
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee zzzzcccclllleeeeaaaarrrr
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _n_o_n_e
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      zzzzcccclllleeeeaaaarrrr sets the z-buffer in the area of the viewport to the largest
  19.      positive z value supported.  When multisample is enabled, and multisample
  20.      buffers exist in the current framebuffer configuration in the current
  21.      drawmode, this value is equal to ggggeeeettttggggccccoooo((((GGGGCCCCMMMMZZZZMMMMAAAA)))).... Otherwise, it is equal
  22.      to ggggeeeettttggggccccoooo((((GGGGCCCCZZZZMMMMAAAAXXXX)))).... Typically zzzzcccclllleeeeaaaarrrr is called prior to rendering each
  23.      frame.  If you intend to clear the color bitplanes as well as the z-
  24.      buffer, or if you require control of the value written to the z-buffer,
  25.      call cccczzzzcccclllleeeeaaaa instead of zzzzcccclllleeeeaaaarrrr.
  26.  
  27.      Because only the normal framebuffer includes a z buffer, zzzzcccclllleeeeaaaarrrr should be
  28.      called only while draw mode is NNNNOOOORRRRMMMMDDDDRRRR.  Also, the current z writemask
  29.      controls which z-buffer bitplanes are modified during zzzzcccclllleeeeaaaarrrr execution,
  30.      and screenmask, when it is set to a subregion of the viewport, bounds the
  31.      cleared region.  Other drawing modes, including polygon fill pattern,
  32.      stenciling, texture mapping, writemask, and z buffering, have no effect
  33.      on the operation of zzzzcccclllleeeeaaaarrrr.
  34.  
  35.      After zzzzcccclllleeeeaaaarrrr executes, the graphics position is undefined.
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      drawmo, getgco, scrmas, setpat, stenci, texbin, wmpack, writem, zbuffe,
  39.      zwrite
  40.  
  41. NNNNOOOOTTTTEEEE
  42.      On the Personal Iris, for performance reasons, the z-buffer is not
  43.      physically cleared when zzzzcccclllleeeeaaaarrrr is called.  Z-buffering works as it
  44.      normally would unless an attempt is made to read back data from the z-
  45.      buffer.  In situations where this is necessary, cccczzzzcccclllleeeeaaaa should be used
  46.      instead of zzzzcccclllleeeeaaaarrrr.  When using cccczzzzcccclllleeeeaaaa, the z-buffer will be physically
  47.      cleared to the specified value, if the specified value is in the range
  48.      -0x800001 to 0x7ffffe.
  49.  
  50.      For performance reasons, XS, XS24, XZ, Elan and Extreme products do not
  51.      physically clear the z-buffer when calling zzzzcccclllleeeeaaaarrrr.  On these systems, the
  52.      LSB of the z-buffer is used as a flag bit to signal that the z-buffer has
  53.      been cleared.  The 23 remaining bits are used for the z comparison.  In
  54.      order to physically clear the z-buffer, first call zzzzffffuuuunnnncccctttt((((ZZZZFFFFAAAALLLLWWWWAAAA)))), then
  55.      draw a polygon whose z coordinates map to the desired z value.  To avoid
  56.      updating the framebuffer, call wwwwmmmmppppaaaacccckkkk((((0000)))) before drawing.  Restore the
  57.      writemask and z function afterwards.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.